Maclife 39/MACLIFE39.ISO.7z/MACLIFE39.ISO/FreeWare200/テキスト関連/LightWayText PPC 1.5.5.sit/LightWayText PPC 1.5.5/マクロサンプル/マクロエディタ説明書

Text File | 1998-01-15 | 18KB | 343 lines

マクロエディタ説明書

１．マクロエディタについて
　マクロエディタはLightWayTextのマクロを編集するツールです。マクロとは、文字入力・キー操作・メニューの実行など、一連の操作を記述して自動実行するスクリプトです。
LightWayTextのマクロは、編集メニュー-キーマクロメニューの「キーマクロ記録」で記述される文字入力・キー操作・メニューの実行にくわえて、マクロ内のジャンプ、変数による計算、比較による条件文の指定、入力ダイアログの表示などが記述できます。
作成したマクロはキーマクロメニューに登録されて、メニューから実行することができます。また、作成したマクロをファンクションキーに割り当てることもできます。
マクロエディタはLightWayTextの編集メニュー-キーマクロメニューの「マクロエディタ...」を実行すると表示されます。
    ﾊ


２．マクロエディタの基本動作
　マクロエディタを開くと、新規マクロの編集状態になります。あらかじめキーマクロ記録を実行しているときは、キーマクロの内容がマクロリストに表示されます。マクロリストには、１番から順にマクロコマンドが表示され、この番号順にマクロコマンドが実行されることになります。新規コマンドポップアップメニューからマクロコマンドを選択すると、マクロリストに追加されます。マクロエディタの右側はマクロコマンド編集エリアとなり、マクロを編集することができます。マクロ名を入力して、「更新」ボタンを押すとキーマクロメニューに登録されます。

２．１．マクロ名：
　編集をおこなうマクロの名前を表示します。すでに登録しているマクロを編集する場合は、マクロ名の編集枠の右にあるﾊポップアップメニューからマクロ名を選択します。ポップアップメニューの「新規マクロ」を選択すると、新規マクロの作成となり、あらかじめキーマクロ記録を実行しているときは、キーマクロの内容がマクロリストに表示されます。そして、マクロ名を入力して新規マクロを登録します。マクロ名を変更すると新しい名前でマクロが登録されます。

２．２．マクロの内容：
　編集するマクロのコマンド一覧がリスト表示されます。マクロリストには、実行されるコマンドが１から順に番号がついて表示されます。マクロリストのアイテムを選択すると、そのコマンドの状態が、マクロエディタの右側のマクロコマンド編集エリアに表示されます。

２．３．新規コマンド：
　新規コマンドのﾊポップアップメニューで、編集中のマクロにマクロコマンドを追加します。マクロコマンドには、メニュー・文字入力・キー操作・ジャンプ・ラベル・変数・比較・検索・問合せ・その他があります。
　新規コマンドを実行すると、マクロリスト内で選択しているアイテムの後ろに挿入されます。Shiftキーを押しながら新規コマンドを実行すると、マクロリスト内で選択しているアイテムの手前に挿入されます。マクロリストのアイテムが何も選択されてないときは、リストの一番最後に追加されます。Shiftキーを押しているとリストの一番最初に挿入されます。

２．４．マクロリストの編集（カット・コピー・ペースト・消去）
　編集メニューからカット・コピー・ペースト・消去を実行することにより、マクロリストを編集することができます。deleteキーで消去が実行されます。
　ペーストを実行すると、マクロリスト内で選択しているアイテムの後ろに挿入されます。Shiftキーを押しながらペーストを実行すると、マクロリスト内で選択しているアイテムの手前に挿入されます。マクロリストのアイテムが何も選択されてないときは、リストの一番最後に追加されます。Shiftキーを押しているとリストの一番最初に挿入されます。

２．５．マクロオプション
　作成したマクロをファンクションキーに割り当てたり、キーマクロメニューに表示しなくするオプションを指定することができます。
　ファンクションキー
　　F1からF15までのファンクションキーにマクロを割り当てます。
　　編集枠に1から15までの数値を入力することでファンクションキーを指定します。
　　15より大きい数字を入力した場合は、実行されません。
　　また、Shift+ファンクションキーとOption+ファンクションキーを指定できます。
　メニュー表示しない
　　マクロを編集メニュー-キーマクロメニューに表示されなくします。
　　ファンクションキーにのみ設定したい場合に利用します。

２．６．読み込む...
　ファイル開くダイアログを表示して、マクロサンプルなどのマクロファイルを読み込みます。マクロを読み込むとキーマクロメニューに自動的に登録されて、マクロエディタの編集画面にマクロの内容が表示されます。

２．７．書き出す...
　ファイル保存ダイアログを表示して、編集中のマクロをファイルとして書き出します。マクロ名がそのままファイル名となります。

２．８．更新
　編集中のマクロを更新してLightWayTextで利用可能にします。新規マクロの場合は、入力したマクロ名でキーマクロメニューに登録されます。また、マクロ名が入力されていないときはキーマクロメニューの「キーマクロ実行」で実行することができるようになります。編集中のマクロにシンタックスエラー（ジャンプ先の番号やラベルが存在しないとき）がある場合は、アラートが表示されて、マクロの修正をうながします。

２．９．マクロコマンド編集エリア
　マクロリスト内のアイテムを選択または、新規コマンドを実行すると、そのコマンドの状態が、マクロエディタの右側のマクロコマンド編集エリアに表示されます。


３．マクロコマンドの説明
　マクロコマンドには、メニュー・文字入力・キー操作・ジャンプ・ラベル・変数・比較・検索・問合せ・その他があり、その内容により編集画面が変わります。

３．１．メニュー
　メニューコマンドを本物のメニューバーから直接選択します。
    ﾊ
　必ず、マクロの内容リストが太枠で囲まれた状態でメニュー選択してください。マクロ名の編集枠にカーソルがあるときはメニュー選択できません。

３．２．文字入力
　文字の編集枠に、LightWayTextにペーストしたい文字列を入力します。改行を含んだ約10000文字が入力できます。
    ﾊ

３．３．キー操作
　LightWayTextのキー操作を指定します。
    ﾊ
　キー操作：
    カーソル移動    左へ移動・右へ移動・上へ移動・下へ移動
                    １単語左へ移動・１単語右へ移動・行の左端へ移動・行の右端へ移動
                    １画面上へ移動・１画面下へ移動・行頭へ移動・行末へ移動
    スクロール        左へスクロール・右へスクロール・上へスクロール・下へスクロール
    文字削除        １文字左を削除・１文字右を削除・１単語左を削除・１単語右を削除
                    行頭までを削除・行末までを削除・１行を削除・行削除の復活
　文字選択
　　カーソル移動のキー操作に文字選択（Shiftキーの動作）を指定できます。
　回数：
　　キー操作の繰り返し回数を指定します。編集枠に1から999までの数値が入力できます。

３．４．ジャンプ
　マクロリスト内でジャンプしてマクロ処理の分岐をおこないます。このジャンプコマンドはプログラミング言語のgoto文に相当します。
    ﾊ
　ジャンプ［番号］        マクロリストのコマンド番号を数値で指定します。
　ジャンプ［ラベル］    ジャンプ先のラベル名を指定します。ラベルコマンドを参照。
　終了する                マクロの実行を終了します。
　番号・ラベル名：        ジャンプ［番号］・ジャンプ［ラベル］を指定したときに、
                        番号を数値で、ラベル名を文字で入力します。
LightWayTextの編集カーソルを行番号ジャンプさせたい場合は、このジャンプコマンドではなく、その他コマンドのなかの「行番号を指定して移動」を使用します。

３．５．ラベル
　ラベルはジャンプコマンドのジャンプ先の名前や、マクロのなかのコメントの記述に利用します。ラベル自体はなにも処理をおこないません。
    ﾊ
　ラベル名：        編集枠にラベル名を文字入力します。

３．６．変数
　マクロの実行中に、数値の計算や、文字列を保持していたいときは変数を利用します。変数には、文字変数と数値変数があり、それぞれ８個まで利用できます。この変数は、後で説明する比較・検索・問合せ・その他のコマンドで使用します。
    ﾊ
　処理対象：        処理の対象となる変数（文字変数1〜8・数値変数1〜8）を指定します。
　処理：            変数に対する処理を指定します。
    初期化            文字変数の内容を空に、数値変数の内容を０にします。
    ペースト        変数の内容を文字列としてLightWayTextにペーストします。
    代入（＝）        文字変数に文字を、数値変数に数値を代入します。
    追加（＋）        文字変数に文字を追加、数値変数に数値を足し算します。
    引算（−）        数値変数に数値を引き算します。
    乗算（×）        数値変数に数値をかけ算します。
    除算（÷）        数値変数に数値をわり算します。処理内容が０だと何もしません。
    剰余（％）        数値変数に数値でわったあまりの数値を代入します。
　処理内容：        処理対象が文字変数のときは文字として、処理対象が数値変数のときは
                    数値として処理をおこないます。
    指定なし                変数に対する処理をおこないません。
    文字・数値                編集枠に文字変数は文字を、数値変数は数値を入力します。
    カーソル位置の文字        カーソル位置の１文字を指定します。
    カーソル行の文字列        カーソル行の１行の文字列を指定します。
    選択された文字列        選択された文字列を指定します。
    カーソル位置の行番号    カーソル位置の行番号を指定します。
    カーソル位置の列番号    カーソル位置の列番号を指定します。
    カーソル行の文字数        カーソル行の１行の文字数を指定します。
    選択終了位置の行番号    選択終了位置の行番号を指定します。
    選択終了位置の列番号    選択終了位置の列番号を指定します。
    選択された文字数        選択された文字数を指定します。選択していないときは0です。
    最終行番号                最終（最大）行番号を指定します。
    文字変数1〜8            文字変数1〜8を指定します。
    数値変数1〜8            数値変数1〜8を指定します。
        カーソル位置とは、選択状態のときは選択開始位置（選択範囲の左上）です。
        選択終了位置とは、選択範囲の右下です。
        処理対象が文字変数で、処理内容が数値のときは、数値を文字列として処理します。
        処理対象が数値変数で、処理内容が文字のときは、0〜9の文字列のときは数値として
        処理します。それ以外の文字列のときは0として処理します。

３．７．比較
　マクロの実行中に、比較による条件文の処理をおこないます。比較が正しいときと違うときのそれぞれにジャンプコマンドを指定することができます。
    ﾊ
　比較対象：        比較の対象となる項目を指定します。
    指定なし                比較対象を数値の０に指定します。
    カーソル位置の文字        カーソル位置の１文字を指定します。
    カーソル行の文字列        カーソル行の１行の文字列を指定します。
    選択された文字列        選択された文字列を指定します。
    カーソル位置の行番号    カーソル位置の行番号を指定します。
    カーソル位置の列番号    カーソル位置の列番号を指定します。
    カーソル行の文字数        カーソル行の１行の文字数を指定します。
    選択終了位置の行番号    選択終了位置の行番号を指定します。
    選択終了位置の列番号    選択終了位置の列番号を指定します。
    選択された文字数        選択された文字数を指定します。選択していないときは0です。
    最終行番号                最終（最大）行番号を指定します。
    文字変数1〜8            文字変数1〜8を指定します。
    数値変数1〜8            数値変数1〜8を指定します。
　条件：            比較に対する条件を指定します。
    同じ（＝＝）            比較対象と比較相手の内容が同じとき。
    違う（！＝）            比較対象と比較相手の内容が違うとき。
    以上（＞＝）            比較対象の内容が比較相手と同じか大きいとき。
    以下（＜＝）            比較対象の内容が比較相手と同じか小さいとき。
    大きい（＞）            比較対象の内容が比較相手より大きいとき。
    小さい（＜）            比較対象の内容が比較相手より小さいとき。
　比較相手：        比較対象が文字変数のときは文字として、比較対象が数値変数のときは
                    数値として比較をおこないます。
    指定なし                比較相手を数値の０に指定します。
    文字・数値                編集枠に比較対象により文字または数値を入力します。
    カーソル位置の文字        カーソル位置の１文字を指定します。
    カーソル行の文字列        カーソル行の１行の文字列を指定します。
    選択された文字列        選択された文字列を指定します。
    カーソル位置の行番号    カーソル位置の行番号を指定します。
    カーソル位置の列番号    カーソル位置の列番号を指定します。
    カーソル行の文字数        カーソル行の１行の文字数を指定します。
    選択終了位置の行番号    選択終了位置の行番号を指定します。
    選択終了位置の列番号    選択終了位置の列番号を指定します。
    選択された文字数        選択された文字数を指定します。選択していないときは0です。
    最終行番号                最終（最大）行番号を指定します。
    文字変数1〜8            文字変数1〜8を指定します。
    数値変数1〜8            数値変数1〜8を指定します。
        カーソル位置とは、選択状態のときは選択開始位置（選択範囲の左上）です。
        選択終了位置とは、選択範囲の右下です。
        比較対象が文字で、比較相手が数値のときは、数値を文字列として比較します。
        比較対象が数値で、比較相手が文字のときは、0〜9の文字列のときは数値として
        比較します。それ以外の文字列のときは0として比較します。

　比較が正しいとき：    比較の結果が正しいときに、ジャンプコマンドを実行します。
    なにもしない            なにもしません。
    ジャンプ［番号］        編集枠にマクロリストのコマンド番号を数値で入力します。
    ジャンプ［ラベル］        編集枠にジャンプ先のラベル名を入力します。
    終了する                マクロの実行を終了します。
　比較が違うとき：        比較の結果が違うときに、ジャンプコマンドを実行します。
    なにもしない            なにもしません。
    ジャンプ［番号］        編集枠にマクロリストのコマンド番号を数値で入力します。
    ジャンプ［ラベル］        編集枠にジャンプ先のラベル名を入力します。
    終了する                マクロの実行を終了します。

３．８．検索
　マクロ実行中に設定した文字変数を利用した検索をおこなうことができます。検索が成功したときと失敗したときのそれぞれにジャンプコマンドを指定することができます。
    ﾊ
　検索対象：            検索対象を指定します。
    文字列                    編集枠に検索文字列を入力します。
    文字変数1〜8            文字変数1〜8を指定します。文字変数の内容で検索します。
　全角・半角を同一視            全角・半角を同一視するか区別するかを指定します。
　ひらがな・カタカナを同一視    ひらがな・カタカナを同一視するか区別するかを指定。
　大文字・小文字を同一視        大文字・小文字を同一視するか区別するかを指定します。
　逆方向に検索                    文書の先頭方向に検索するかを指定します。
　正規表現                    正規表現による条件検索を指定します。
                            詳しくはLightWayText説明書「５．正規表現による条件検索」
                            の項を参照してください。

　検索に成功したとき：    検索に成功したときに、ジャンプコマンドを実行します。
    なにもしない            なにもしません。
    ジャンプ［番号］        編集枠にマクロリストのコマンド番号を数値で入力します。
    ジャンプ［ラベル］        編集枠にジャンプ先のラベル名を入力します。
    終了する                マクロの実行を終了します。
　検索に失敗したとき：    検索に失敗したときに、ジャンプコマンドを実行します。
    なにもしない            なにもしません。
    ジャンプ［番号］        編集枠にマクロリストのコマンド番号を数値で入力します。
    ジャンプ［ラベル］        編集枠にジャンプ先のラベル名を入力します。
    終了する                マクロの実行を終了します。

３．９．問合せ
　入力ダイアログを利用した文字・数値入力と、アラートによるメッセージ表示の問合せをおこないます。入力ダイアログのときは、問合せがＯＫのときとキャンセルのときのそれぞれにジャンプコマンドを指定することができます。
    ﾊ
　入力ダイアログ        入力ダイアログを指定します。
　アラート表示            アラート表示を指定します。
　メッセージ：            編集枠にメッセージを入力します。メッセージが未入力のときは、
                        処理対象に指定した文字変数の内容をメッセージとして表示します。
　処理対象：            入力ダイアログで入力した文字列を格納する変数を指定します。
    文字変数1〜8            文字変数に文字列を格納します。
    数値変数1〜8            数値変数に数値を格納します。

　問合せがＯＫのとき：    問合せがＯＫのときに、ジャンプコマンドを実行します。
    なにもしない            なにもしません。
    ジャンプ［番号］        編集枠にマクロリストのコマンド番号を数値で入力します。
    ジャンプ［ラベル］        編集枠にジャンプ先のラベル名を入力します。
    終了する                マクロの実行を終了します。
　問合せがキャンセルのとき：    問合せがキャンセルのときに、ジャンプコマンドを実行。
    なにもしない            なにもしません。
    ジャンプ［番号］        編集枠にマクロリストのコマンド番号を数値で入力します。
    ジャンプ［ラベル］        編集枠にジャンプ先のラベル名を入力します。
    終了する                マクロの実行を終了します。

３．１０．その他
　LightWayTextの状態の設定と取得の処理を、その他のコマンドとしてまとめました。
    ﾊ
　処理内容：
　　なにもしない            なにもしません。
　　次のウインドウに移動    次のウインドウを編集可能状態にします。
　　前のウインドウに移動    前のウインドウを編集可能状態にします。
    　ウインドウの次と前は、ウインドウメニューに表示されている文書名の順番となります。
    　処理対象に文字変数を指定したときは、文字変数の内容を文書名として、指定した名前
    　のウインドウを編集可能状態にします。指定した名前のウインドウが開いていないとき
    　は、最近の書類メニューの書類名リストを検索して、見つかればその書類を開いて編集
    　可能状態にします。
　　行番号を指定して移動    処理対象に指定した数値変数の内容で行番号ジャンプします。
　　文書名を設定            処理対象に指定した文字変数の内容を文書名にします。
　　文書名を取得            処理対象に指定した文字変数に文書名を格納します。
　　今日の日付を取得        処理対象に指定した文字変数に日付を格納します。
                            処理対象に数値変数を指定したときは次の形式で格納します。
                            （例）1998年 1月 5日（月） ->  199801052
                            　　　数値の下１桁は曜日で1:日,2:月,．．,7:土となります。
　　現在の時刻を取得        処理対象に指定した文字変数に時刻を格納します。
                            処理対象に数値変数を指定したときは次の形式で格納します。
                            （例）4 : 25 PM  ->  162500
                            　　　数値の下2桁は秒数で00から59となります。
　　行番号スタート            処理対象に指定した数値変数の内容で行番号スタートします。
　　行番号クリア            処理対象に指定した数値変数の内容で行番号クリアします。
                            処理対象になにも指定していない場合は、LightWayTextの
                            現在のカーソル行で行番号スタート・行番号クリアします。


４．登録したマクロの削除
　登録したマクロをLightWayTextから削除する場合は、編集メニュー-キーマクロメニューの「キーマクロ設定...」を実行してキーマクロ設定ダイアログで削除します。
    ﾊ


５．マクロの作成例
　マクロの作成例をマクロリストの表示形式であらわします。

（例１）行末のスペース削除
　文書内のすべての行末の半角スペース・全角スペース・タブを削除するマクロ
    1　キー操作　先頭行へ移動
    2　ラベル　　loop1
    3　検索　　　[ 　¥t]+$+正（失敗）終了する
    4　キー操作　１文字左を削除
    5　ジャンプ　ラベル：loop1

（例２）選択文字列で検索・置換...
　検索・置換...で選択文字列を検索対象にするマクロ
    1　比較　　　選択された文字数 == 0 （正）ラベル：skip1
    2　メニュー　検索文字列を設定
    3　ラベル　　skip1
    4　メニュー　検索・置換...

（例３）日付ペースト
　今日の日付をLightWayTextにペーストするマクロ
    1　その他　　今日の日付を取得+文字変数1
    2　変数　　　文字変数1ペースト

（例４）日付を平成でペースト
　今日の日付を西暦から平成に変換してLightWayTextにペーストするマクロ
    1　その他　　今日の日付を取得+数値変数1
    2　文字入力　平成
    3　変数　　　数値変数2＝数値変数1
    4　変数　　　数値変数2÷100000
    5　変数　　　数値変数2−1988
    6　変数　　　数値変数2ペースト
    7　文字入力　年
    8　変数　　　数値変数2＝数値変数1
    9　変数　　　数値変数2÷1000
    10 変数　　　数値変数2％100
    11 変数　　　数値変数2ペースト
    12 文字入力　月
    13 変数　　　数値変数2＝数値変数1
    14 変数　　　数値変数2÷10
    15 変数　　　数値変数2％100
    16 変数　　　数値変数2ペースト
    17 文字入力　日

（例５）選択範囲の行のソート
　選択範囲の行を小さい順に並べ替えるマクロ
    1　変数　　　数値変数1＝カーソル位置の行番号
    2　変数　　　数値変数2＝選択終了位置の行番号
    3　比較　　　数値変数1 == 数値変数2（正）終了する
    4　ラベル　　loop1
    5　変数　　　文字変数1＝カーソル行の文字列
    6　変数　　　数値変数3＝数値変数1
    7　変数　　　数値変数4初期化
    8　ラベル　　loop2
    9　比較　　　数値変数3 >= 数値変数2（正）ラベル：skip1
    10 変数　　　数値変数3＋1
    11 その他　　行番号を指定して移動+数値変数3
    12 比較　　　カーソル行の文字列 >= 文字変数1（正）ラベル：loop2
    13 変数　　　文字変数2＝カーソル行の文字列
    14 キー操作　１行を削除
    15 変数　　　文字変数1ペースト
    16 キー操作　上へ移動
    17 変数　　　文字変数1＝文字変数2
    18 変数　　　数値変数4＝1
    19 ジャンプ　ラベル：loop2
    20 ラベル　　skip1
    21 その他　　行番号を指定して移動+数値変数1
    22 比較　　　数値変数4 == 0（正）ラベル：skip2
    23 キー操作　１行を削除
    24 変数　　　文字変数1ペースト
    25 キー操作　上へ移動
    26 ラベル　　skip2
    27 変数　　　数値変数1＋1
    28 キー操作　下へ移動
    29 比較　　　数値変数1 < 数値変数2（正）ラベル：loop1